Oxoscript se transforme en NanoPy - plus d'infos

Fonctions système

setLanguage

  setLanguage(byte lang)

Définit la langue du système de l’appareil.

Langues disponibles:

C_LANGUAGE_EN
C_LANGUAGE_DE
C_LANGUAGE_FR

getLanguage

  getLanguage()->byte

Renvoie la langue du système actuellement définie.

Langues disponibles:

C_LANGUAGE_EN
C_LANGUAGE_DE
C_LANGUAGE_FR

getHardwareType

  getHardwareType()->byte

Renvoie le type d’oxocard actuellement utilisé.

C_HW_GALAXY = 0
C_HW_ARTWORK = 1
C_HW_SCIENCE = 2
C_HW_SCIENCE_PLUS = 3
C_HW_CONNECT = 4

textInput

  textInput(title:byte[], text:byte[])->byte[120]

Ouvre un champ de saisie de texte et renvoie le texte saisi dès que l’icône OK est sélectionnée et confirmée.

str = textInput("Test", "123")
print(str)

isConnected

  isConnected()->bool

Renvoie true si la carte est connectée à Internet.

runScript

  runScript(path:byte[])

Lance un script précédemment téléchargé ou enregistré sous forme de fichier.

Le script actuel est arrêté et remplacé par le nouveau script.

Si le script n’existe pas, une erreur d’exécution “fichier introuvable” est générée.

Les scripts téléchargés sont placés dans le dossier “user_scripts”. Le nom du fichier correspond au nom dans l’éditeur, par exemple “My downloaded script”.

runScript("user_scripts/My downloaded script")

Exemple de fichier:

if fileExists("hello.tc"):
    deleteFile("hello.tc")

open(C_WRITE, "hello.tc")
code = "drawText(35, 10, \"Hello World!\")\nupdate()"
i = 0
ch = code[i]
while ch != 0:
    writeByte(ch)
    i++
    ch = code[i]
close()

runScript("hello.tc")

backlight

  backlight(value:float)

Active (value=1) ou désactive (value=0) le rétroéclairage de l’écran TFT.

Avec des valeurs entre 0 et 1 (par ex. 0.1), l’écran TFT peut également être atténué.

Attention ! Comme l’œil humain ne perçoit pas la lumière de manière linéaire (mais logarithmique), ce n’est qu’avec des valeurs plus faibles que l’on remarquera une différence marquante.

background(0, 255, 0)
drawText(60, 80, "Test123")
update()
for i in 20:
    backlight(1.0 - 0.05*i)
    delay(500)

ipAddress

  ipAddress()->byte[16]

Renvoie l’adresse IP actuelle sous forme de chaîne (byte array).
Si la carte n’est pas connectée à Internet, “0.0.0.0” est renvoyé.

ipAddress() # => "192.168.42.164"

sleep

  sleep(sec:long)

Éteint l’Oxocard et le fait redémarrer après x secondes.

turnOff

  turnOff()

Éteignez l’Oxocard.

setAutostart

  setAutostart()

Si la fonction Autostart a été activée, le redémarrage de l’Oxocard (après la connexion à Internet) permet de passer directement au programme de démarrage.

setAutostart(true)
setAutostart(false)

print

  print(str:byte[])

Envoie le paramètre de chaîne défini au terminal dans l’éditeur NanoPy.

print("Bonjour le monde !")

Si un nombre ou une variable est passé à la fonction print(), il est automatiquement converti en une chaîne de caractères (ou byte[]):

print(123) # "123"
a = 1.23
print(a) # "1.23"

Il est même possible de mélanger des textes et des chiffres ou des variables:

v = vector(x=5,y=10)
print("x = " + v.x + "; y = " + v.y) # "x = 5.0; y = 10.0"

setPrecision

  setPrecision(val:byte)

Formate les décimales lors de l’édition de valeurs flottantes:

f = 1.23931
setPrecision(2)
print(f) # "1.24"
setPrecision(4)
print(f) # "1.2393"

restart

  restart()

Redémarre la carte.

returnToMenu

  returnToMenu()->bool

Cette fonction permet de revenir au menu.
La valeur de retour indique si l’utilisateur a vraiment quitté le programme..

    if getButton():
        if returnToMenu():
            return